home *** CD-ROM | disk | FTP | other *** search
/ Apple Developer Connection 1998 Fall: Game Toolkit / Disc.iso / SDKs / Mac OS USB DDK_v1.0.1 / Mac OS USB Compatibility Notes next >
Encoding:
Text File  |  1998-09-03  |  4.8 KB  |  90 lines  |  [ttro/ttxt]

  1.  ***
  2.  ***       Universal Serial Bus™ (USB) for the Mac OS
  3.  ***    Mac OS USB Compatibility Notes
  4.  ***    Copyright 1998 Apple Computer, Inc.
  5.  ***
  6.  
  7.  
  8.  Table of Contents:
  9. -------------------------------------------------------------
  10.  ADB/USB Compatability
  11.  Serial Port/USB Compatability
  12.  Universal HID Module
  13. -------------------------------------------------------------
  14.  
  15.  
  16.  ADB/USB Compatibility
  17. ----------------------
  18.  
  19. While the iMac is the first Macintosh system which does not provide an ADB port (excluding the PowerBook 145), we are providing an ADB/USB shim to support processes which make ADB Manager and Cursor Device Manager calls to control ADB devices.  For example, such calls are often made to control extended keyboard LEDs and the cursor. It is important to understand that the shim will not support other types of ADB devices. The ADB/USB shim makes it possible for processes that expect an ADB keyboard and/or mouse to work seamlessly with the USB keyboard and mouse. 
  20.  
  21. The ADB/USB shim is built into the "ROM in RAM" image on the iMac and will be included in the "ROM in RAM" image of future Power Macintosh systems which provide USB support. The ADB/USB shim is not included in the extension based USB components that one uses with the PCI USB cards. On an iMac, this means that one can make ADB Manager and Cursor Device Manager calls to see available USB keyboards and USB relative positioning devices.   However, for existing PCI Power Macs which use the OPTi or CMD PCI USB cards, the USB devices will not be reported in responses of calls to the ADB Manager.  
  22.  
  23.  
  24.  Serial Port/USB Compatability
  25. ------------------------------
  26.  
  27. In contrast to the ADB/USB shim, there is no universal Serial/USB shim as part of the first release of Mac OS USB DDK. The expected use of such a shim would be to allow processes which uses the Communication Toolbox CRM calls to identify available serial ports, to support both the standard Device Manager I/O and the classic Serial Driver API, and to provide a Mac OS interface for a USB Communication Class device driver.
  28.  
  29. For a coming release of the Mac OS USB DDK (following the iMac intro), we may provide a sample USB Communication Class driver which would support most USB Comm class devices that implement the Abstract Control Model as per the "USB Class Definitions for Communications Devices" document. The
  30. proposed USB Communication Class driver would depend upon the existence of a Serial/USB shim as mentioned above, which Apple may also provide in a coming release of the Mac OS USB DDK.
  31.  
  32. For the introduction of the iMac system, a USB Communication Class Driver will need to implement a communication shim for handling Serial Driver calls between applications and itself.
  33.  
  34. IMPORTANT NOTE: Any Serial/USB shim which we might provide will not be designed to support LocalTalk nor other externally clocked processes from a USB Serial Device.
  35.  
  36.  
  37.  USB Universal HID Module
  38. -------------------------
  39. The USBHIDUniversalModule is provided to support third party USB gaming devices. In most cases developers of HID devices can write an InputSprocket rather than a USB HIDModule.
  40.  
  41. The InputSprocket SDK includes two sample ISp drivers with source code:
  42. (1) a sample USB driver which talks to the USBHIDUniversalModule. 
  43. (2) a sample ADB driver which talks to the MS Sidewinder 3D Pro (ADB)
  44. (Note the the InputSprocket SDK is not included as part of the Mac OS USB DDK)
  45.  
  46. InputSprocket 1.3 includes a driver 'InputSprocket USB' which supports several 3rd party gaming devices by talking with USBHIDUniversalModule.
  47.  
  48. The list of third party USB gaming devices which are supported, is listed below.
  49.  
  50. • ALPS Game Pad
  51. • Gravis Game Pad Pro
  52. • Microsoft Sidewinder game pad
  53. • Microsoft Sidewinder Precision Pro Joystick
  54. • Thrustmaster TopGun Joystick
  55.  
  56. 'InputSprocket USB' also supports mice through a different mechanism.
  57. • Apple USB Mouse
  58. • All compatible USB mice
  59.  
  60. The roller on roller USB mice is not currently supported, but will be supported in a future version of InputSprocket USB.
  61.  
  62. For these USB gaming devices, you will need to install the following components into the Extension folder.
  63. 1. USBHIDUniversalModule
  64. 2. InputSprocket USB
  65. 3. InputSprocket Keyboard
  66. 4. InputSprocketLib
  67. 5. the following inputSprocket support libs (omit drivers for devices which you don't have.)
  68.  
  69. - InputSprocket CH
  70. - InputSprocket CH Trackball
  71. - InputSprocket Contour
  72. - InputSprocket Gravis
  73. - InputSprocket Kensington
  74. - InputSprocket Keyboard
  75. - InputSprocket MacALLY
  76. - InputSprocket Microspeed
  77. - InputSprocket Mouse
  78. - InputSprocket NoHandsMouse
  79. - InputSprocket SideWinder 3D Pro
  80. - InputSprocket Speech
  81. - InputSprocket Thrustmaster
  82.  
  83. You can obtain the InputSprocket 1.3 SDK and these support libs from the Game Sprockets Download page. Use the URL below to access the Game Sprockets Downloads page.
  84.  
  85.        <http://developer.apple.com/dev/games/>
  86. or
  87.        <ftp://ftp.apple.com/devworld/Games/>
  88.  
  89.  
  90.